home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Mac Game Programming Gurus / TricksOfTheMacGameProgrammingGurus.iso / Tools / ShareDisk 2.2.2 / For Power Users Only / Traps Check 1.1 / Traps Check / Traps Check.rsrc / TEXT_5000.txt < prev    next >
Encoding:
Text File  |  1995-03-23  |  4.2 KB  |  43 lines

  1. Alessandro Levi Montalcini
  2. C.so Re Umberto 10
  3. 10121 Torino
  4. Italy
  5. e-mail: LMontalcini@pmn.it
  6. anonymous ftp: //ftp.alpcom.it/software/mac/LMontalcini
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13. Traps Check 1.1 docs - March 1995
  14.  
  15. ‚Ä¢ Introduction
  16. ‚óä  Traps Check is a free utility that inspects all the documented toolbox and operating system traps and tells whether they are implemented as native PowerPC code or as 680x0 code. The results are saved in a text file with tabs; you can use your word processor to display or print the list better than with SimpleText.
  17.  
  18. ‚Ä¢ Tech info
  19. ‚óä  Traps Check looks for the _MixedModeMagic pseudo-trap, which is at the beginning of all routine descriptors. It doesn‚Äôt check if the routine descriptor really contains PowerPC code (although this wouldn‚Äôt be hard) because it‚Äôs unlikely that a routine descriptor is created for a 68K-only trap. Should a 68K-only routine descriptor exist for a given trap, Traps Check would incorrectly report it as a native trap.
  20. ‚óä  Traps Check can‚Äôt do anything to tell you about split traps, i.e. traps that are implemented both as PowerPC and 68K code but have no routine descriptor because two separate versions are available to PowerPC and 68K applications. Apple says that only a few traps have been implemented as split traps, since split traps can‚Äôt be patched safely. Anyway, split traps always show up as 68K-only traps in the Traps Check report.
  21.  
  22. ‚Ä¢ System check
  23. ‚óä  If you build a report on a Power Macintosh with all the extensions disabled (shift key down at startup) and another one with all your extensions and control panels installed, you may find some differences when comparing the two files. Native PowerPC traps that are patched with 68K code by an extension are listed as 68K traps. These patches cause mode switches (the Power Mac must go from native to emulated mode and back) and can slow down even the fastest processor. Older screen savers, for example, patch all the QuickDraw bottlenecks - which are written in fast PowerPC code on the Power Macs. The performance degradation, which was not noticeable on 68K Macs, can be annoying on a Power Macintosh. You may want to leave these extensions and control panels out of your System folder until a PowerPC-aware version is available.
  24.  
  25. ‚Ä¢ Compatibility
  26. ‚óä  Traps Check is compiled as 68K code (it can‚Äôt be compiled as native code for technical reasons) and runs both on 68K and Power Macs. On a standard 68K Mac all traps are always 68K, but you can still use it to see which traps are not implemented on your machine. For those who don‚Äôt have a Power Macintosh, a sample report generated by a 6100/60 running system 7.5 is included.
  27.  
  28. ‚Ä¢ Version history
  29. ‚óä  1.1 - Updated the traps list from Apple‚Äôs Universal Headers 2.0a3, recompiled with CodeWarrior, added online documentation.
  30. ‚óä  1.0 - First public release.
  31.  
  32. ‚Ä¢ Distribution
  33. ‚óä  Traps Check is ¬©1994-95 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and there‚Äôs no charge for it, but it may not be included in any commercial package without my consent.
  34. ‚óä  You may find the latest version of all my shareware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The complete ShareDisk package, which contains all my stuff and can be registered at a very low price, is also available there.
  35. ‚óä  All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees.
  36. ‚óä  All non-profit user groups may distribute it at no charge.
  37. ‚óä  All magazines may publish it on floppy disk without asking me first, as long as I get a copy of the issue containing my software.
  38. ‚óä  All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price.
  39. ‚óä  All redistribution companies such as Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the company‚Äôs offerings (where applicable).
  40.  
  41. ‚Ä¢ Disclaimer
  42. ‚óä  Traps Check shouldn‚Äôt cause any damage, but you‚Äôre using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it.
  43.